Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Move Datafusion Query Optimizer to library user guide #11563

Merged
merged 4 commits into from
Jul 22, 2024

Conversation

devesh-2002
Copy link
Contributor

Which issue does this PR close?

Closes #11497 .

Rationale for this change

Since, the optimizer Readme is not visible on the main docs page, this change was needed.

What changes are included in this PR?

I have tried to add the content of https://github.com/apache/datafusion/tree/main/datafusion/optimizer#readme in the Library User Guide in the docs.

Are these changes tested?

Yes, I have tested. However, I may need some more help.

@github-actions github-actions bot added the documentation Improvements or additions to documentation label Jul 20, 2024
@alamb alamb changed the title Added Datafusion Query Optimizer to user guide Added Datafusion Query Optimizer to library user guide Jul 20, 2024
Copy link
Contributor

@alamb alamb left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @devesh-2002 ! This is looking like a great start

I built the docs locally and tested it out.

cd docs
./build.sh
open build/html/index.html

The new page doesn't seem to be in the index -- I think you have to add an entry here:

library-user-guide/using-the-dataframe-api

Also, can you please remove the old copy at https://github.com/apache/datafusion/tree/main/datafusion/optimizer#readme and instead leave a link to the new location (e.g. I think the url will be

https://datafusion.apache.org/library-user-guide/<filename>.html

@@ -0,0 +1,336 @@
<!---
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Perhaps can we name this file query-optimizer.md rather than datafusion-query-optimizer.md? I think the datafusion is redundant

@github-actions github-actions bot added the optimizer Optimizer rules label Jul 20, 2024
@devesh-2002
Copy link
Contributor Author

Thanks for the help! I have made some changes now. Please let me know, if any further changes are needed.

@alamb alamb changed the title Added Datafusion Query Optimizer to library user guide Move Datafusion Query Optimizer to library user guide Jul 21, 2024
@alamb
Copy link
Contributor

alamb commented Jul 21, 2024

Thank you @devesh-2002 -- this looks great 🙏

I pushed a commit to resolve a CI failure and I think this looks good to god

@alamb
Copy link
Contributor

alamb commented Jul 22, 2024

I also filed #11581 to track updating this content

@alamb alamb merged commit f9457de into apache:main Jul 22, 2024
6 checks passed
@alamb
Copy link
Contributor

alamb commented Jul 22, 2024

Thanks again @devesh-2002

Lordworms pushed a commit to Lordworms/arrow-datafusion that referenced this pull request Jul 23, 2024
* Added Datafusion Query Optimizer to user guide

* Updated Query optimizer name, Added to index and replaced the README content

* Fix RAT check

---------

Co-authored-by: Andrew Lamb <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation optimizer Optimizer rules
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Consolidate optimizer readme into datafusion user guide
2 participants